home *** CD-ROM | disk | FTP | other *** search
/ Stac Reachout 7 / Stac Reachout 7.iso / STACFAX / 8516.TXT < prev    next >
Text File  |  1997-01-31  |  8KB  |  163 lines
  1.       -----------------------------------------------------------------
  2.       STAC NOTE                                               STAC NOTE
  3.                  CONFIGURING TCP/IP NETWORK LIST DESCRIPTION
  4.              (Applies to ReachOut Vversions 6.x for Windows 3.1)
  5.       STAC FAX  8516 (09-25-1996)
  6.       -----------------------------------------------------------------
  7.                  CONFIGURING TCP/IP NETWORK LIST DESCRIPTION
  8.              (Applies to ReachOut Vversions 6.x for Windows 3.1)
  9.                                       
  10.       BACKGROUND
  11.       
  12.       ReachOut users have had the ability to choose from a list of
  13.       available ReachOut Network Hosts with IPX, NetBIOS, SAP and
  14.       Banyan Vines, but not Winsock.  Recognizing the value of similar
  15.       functionality with Winsock based networks, STAC added Winsock
  16.       Network List to ReachOut.  The design was intended to match as
  17.       closely as possible the existing network list functionality for
  18.       IPX, Netbios, SAP, and Banyan Vines without compromising on
  19.       speed and stability.
  20.       
  21.       Because Winsock based networks can include the Internet, some
  22.       method of limiting the number of addresses checked for the
  23.       presence of a valid ReachOut Host must be employed. If this was
  24.       not done the list itself could become unmanageable both in size
  25.       and in wait time to build the list. To achieve this, a new section
  26.       was added to the REACHOUT.INI file, called [IP ADDRESS], and the
  27.       information contained in this section configures the search for
  28.       valid ReachOut Hosts to be limited to a manageable range of IP
  29.       addresses.
  30.       
  31.       After upgrading to or installing ReachOut 6.0 for Windows 3.1,
  32.       add this new section ([IP ADDRESS]) to the existing REACHOUT.INI
  33.       file in order to enable the Winsock Network list.  Since the INI
  34.       file is crucial to the proper operation of ReachOut a backup copy
  35.       of it should be made before making any changes.  After the backup
  36.       is created, the INI file will be edited to include the [IP ADDRESS]
  37.       section along with its contents.
  38.       
  39.       SOLUTION
  40.       
  41.       There are two steps required to implement this feature:
  42.       *  Make a backup copy of the existing REACHOUT.INI.
  43.       *  Modify the REACHOUT.INI to include the new section [IP
  44.          ADDRESS] and addresses to be checked for ReachOut Hosts.
  45.       
  46.       Making a backup copy of the REACHOUT.INI file useing the Windows
  47.       File manager:
  48.       1.   Double click on the File Manager ICON in the Main Group.
  49.       2.   Select the drive where Windows is installed (typically
  50.            drive C:).
  51.       3.   Locate the Windows directory (typically WINDOWS).
  52.       4.   Locate the file REACHOUT.INI.
  53.       5.   Select that file by pointing to it with the Mouse and
  54.            clicking once.
  55.       6.   Press the F8 Key (this copies the file).
  56.       7.   A Dialog Box asks for a file name, type in REACHINI.BAK and
  57.            click on OK.
  58.       8.   Close File manager.
  59.       
  60.       Modifying the REACHOUT.INI:
  61.       1. Double click on the REACHOUT.INI.
  62.       2. Once the INI file is loaded in Notepad, press Enter.
  63.       3. Type the following:
  64.          [IP ADDRESS], press ENTER, then following the example below.
  65.          Add the TCP/IP addresses and address ranges desired.
  66.       4. Press ALT- F4 to close Notepad when done.
  67.       5. A prompt to save changes will appear, choose yes.
  68.       
  69.       Here is an example of a correctly formatted [IP ADDRESS] INI section.
  70.       
  71.       [IP Addresses]
  72.       Address1=199.105.175.65
  73.       Group1=199.105.175.110-199.105.175.120
  74.       Group2=199.105.170.10-199.105.170.30
  75.       Address2=199.105.176.75
  76.       
  77.       The descriptive text (called Keywords) are unimportant to the
  78.       proper operation of the Winsock list function, but choose ones
  79.       that have some meaning to in relation to the addresses.  Exercise
  80.       caution regarding the size and the number of them, since the
  81.       larger the number of characters used the more memory ReachOut
  82.       uses to maintain this list for active functions.
  83.       
  84.       Note in the example of the [IP ADDRESS] section there are some
  85.       Keywords called Group1 and Group2.  These are examples on how
  86.       to have ReachOut look for valid ReachOut Hosts over a range of
  87.       TCP/IP addresses without adding each individual address to the
  88.       INI file.  In the case of Group2, ReachOut will check TCP/IP
  89.       addresses from 199.105.170.10 to 199.105.170.30 for Hosts.
  90.         
  91.       Incorrect addresses will be disregarded, and care need be taken
  92.       to prevent this from occurring, below are a few examples of
  93.       incorrect addresses that will be ignored:
  94.       
  95.       [IP Addresses]
  96.       Address1=joe.smoe.stac.com
  97.       Group1=199.105.175.110-199.105.175.100
  98.       Group2=199.105.170.10                 -199.105.170.30
  99.       
  100.       ADVANCED OPTIONS
  101.       
  102.       These features may be used by administrators and advanced users
  103.       to assist in controlling ReachOut's Winsock Network list polling
  104.       feature.  These functions would be added to the [WINSOCK] section
  105.       of the ReachOut INI file, and are detailed below.
  106.       
  107.       KeywordBufSize=
  108.       
  109.       The size of the buffer to hold the list of address keywords is 2048
  110.       bytes by default.  It will allow you to set it as low as 512 bytes
  111.       and as high as 10240 bytes.  This allows use of larger Keyword lists,
  112.       or lists with long Keywords.  Testing has shown the default for this
  113.       setting to perform well in most cases.
  114.       
  115.       AddressBufSize=
  116.       
  117.       The size of the buffer to hold the current address is 256 bytes
  118.       by default.  It will allow you to set it as low as 128 bytes and
  119.       as high as 2048 bytes.  More space is unlikely to be needed
  120.       unless full DNS name support is added at a later date.
  121.       
  122.       PollingTimeout=
  123.       
  124.       The number of milliseconds to attempt to find a given address is
  125.       2000 would be (2 seconds) by default.  It will allow you to
  126.       set it as low as 0 and as high as 10000 milliseconds would be (10
  127.       seconds). Setting this number too small can result in host machines
  128.       not appearing on the list and that should.  Setting this number
  129.       too high can result in unnecessary performance penalties.
  130.             
  131.       ConnectDelay=
  132.       
  133.       The number of milliseconds to delay before connecting on a
  134.       connect to first available attempt.  This is required because the
  135.       host machine that we just queried needs time to get set back up.
  136.       The default is 1000 milliseconds (1 second).  The range is from 0
  137.       to 10000 milliseconds (10 seconds).  Setting this number too low
  138.       can result in not being able to connect to a machine when using
  139.       the connect to first available feature.  To long can result in
  140.       performance penalties.
  141.       
  142.       ReceiveDelay=
  143.       
  144.       The number of milliseconds to delay after connecting during the
  145.       polling before attempting to receive.  The default is 500
  146.       milliseconds (1/2 second).  The allowable range is from 0 to
  147.       10000 milliseconds (10 seconds).
  148.       
  149.       Again, these options have default values and are not required.
  150.       An example of the [winsock] section reflecting the settings at
  151.       their default values is:
  152.       
  153.       [winsock]
  154.       keywordbufsize=2048
  155.       addressbufsize=128
  156.       pollingtimeout=2000
  157.       connectdelay=1000
  158.       receivedelay=500
  159.       ConnectDelay=
  160.       
  161.       -----------------------------------------------------------------
  162.       Copyright 1996 Stac, Inc.
  163.